L'API Surveillance des eaux littorales diffuse les données gérées et valorisées par l'Institut français de recherche pour l'exploitation de la mer (IFREMER) à travers le système d'information QUADRIGE.
QUADRIGE regroupe de nombreuses thématiques : Phytoplancton et hydrologie, suivi environnemental de centrale nucléaire, Microbiologie, Benthos, ...). Chacune de ces thématiques fera l'objet d'un endpoint (opération) de l'API Surveillance des eaux littorales. La thématique Contaminants chimiques et écotoxicologie a été choisie pour initier la diffusion des données de QUADRIGE via Hub'Eau.
Source des données : Système d'information Quadrige de l'IFREMER.
Les données sont exposées sous la forme d'une API REST.
Les formats supportés sont : JSON, GeoJSON et CSV.
L'API "Surveillance du Littoral" est accessible :
Pour gérer le cross-domain, l'API supporte les protocoles :
Chaque page renvoie un nombre de résultats égal au paramètre size.
L'API Surveillance du Littoral utilise un type de pagination non séquentiel qui permet de sauter d'une page à l'autre de résultats dans n'importe quel ordre. En contre-partie, la profondeur d'accès aux résultats est limitée.
Paramètres
Attributs
Un tutoriel sur l'API Qualité des cours d'eau explique, dans la partie Taille des pages de réponse, la mise en oeuvre pratique de la pagination à l'aide d'un cas concret.
Enfin, des exemples de code en Python, R et php sont disponibles dans la partie Exemples de la page de contribution GitHub de Hub'Eau.
La longueur maximale d'une URL est de 2 083 caractères, la requête est bloquée si la limite de longueur est dépassée.
L'API "Surveillance du Littoral" propose actuellement 2 opérations :
NB : Les analyses des différentes thématiques de QUADRIGE seront progressivement disponibles et feront l'objet de nouveaux endpoints. A noter que le endpoint lieux_surv fournit l'ensemble des lieux de surveillance, y compris ceux n'ayant pas de mesures sur la thématique Contaminants chimiques et écotoxicologie, pour être complet quand les autres thématiques seront disponibles. Pour interroger seulement les lieux de surveillance avec des données de contaminants chimiques, ajoutez le paramètre donnees_cc=true à votre requête.
1. Lister tous les lieux de surveillance possédant des données de contaminants chimiques :
La paramètre à utiliser est donnees_cc. L'URL à interroger est : https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true
Résultat :
{
{
"count": 353,
"first": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&page=1&size=1000",
"last": null,
"prev": null,
"next": null,
"api_version": "v1",
"data": [
{
"code_lieusurv": "1001104",
"libelle_lieusurv": "001-P-022 - Oye plage",
"mnemo_lieusurv": "001-P-022",
"ecart_heureTU_lieusurv": 1,
"prof_lieusurv": -1,
"coordonnee_x_lieusurv": 2.00455,
"coordonnee_y_lieusurv": 51.002766,
"code_projection": "31",
"type_acquisition_coord": "3",
"codes_masses_eau": [
"FRAC02"
],
"noms_masses_eau": [
"FRAC02 - Jetée de Malo à Est cap Griz nez"
],
"commentaire": "Coordonnées modifiées le 20/09/2019 à la demande du LER/BL validée par les coordinateurs des réseaux concernés car anciennes coordonnées fausses (hors zone d'exploitation des coquillages) anciennes coordonnées lat = 51.0024777513, long = 1.9986607303 (positionnement IGN non défini)",
"date_creation": "1900-01-01T00:00:00Z",
"date_maj": "2019-09-20T00:00:00Z",
"date_debut_donnees": "1987-06-29T00:00:00Z",
"date_fin_donnees": "2021-02-02T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000110"
],
"noms_reseaux": [
"Réseau de contrôle microbiologique des zones de production conchylicoles (REMI)",
"Réseau de contrôle microbiologique (REMI) - Surveillance",
"Réseau de Surveillance du Phytoplancton et des Phycotoxines (REPHY)",
"Réseau National d'Observation de la qualité du milieu marin (RNO) - Matière vivante",
"Réseau de surveillance du phytoplancton et des phycotoxines (REPHY) - Toxines"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"donnees_cc": true,
"longitude": 2.00455,
"latitude": 51.002766,
"geometry": {
"type": "Point",
"crs": {
"type": "name",
"properties": {
"name": "urn:ogc:def:crs:OGC:1.3:CRS84"
}
},
"coordinates": [
2.00455,
51.002766
]
},
"uri_reseaux": [
"https://id.eaufrance.fr/dc/0000000010",
"https://id.eaufrance.fr/dc/0000000013",
"https://id.eaufrance.fr/dc/0000000014",
"https://id.eaufrance.fr/dc/0000000020",
"https://id.eaufrance.fr/dc/0000000110"
],
"uri_taxons_suivis": [
"https://id.eaufrance.fr/apt/3432"
]
},
{
"code_lieusurv": "1001105",
"libelle_lieusurv": "001-P-023 - Digue du Braek",
"mnemo_lieusurv": "001-P-023",
"ecart_heureTU_lieusurv": 1,
"prof_lieusurv": null,
"coordonnee_x_lieusurv": 2.2903323,
"coordonnee_y_lieusurv": 51.052483,
"code_projection": "31",
"type_acquisition_coord": "1",
"codes_masses_eau": [
"FRAC02"
],
...
...
}
353 lieux de surveillance sont concernés.
2. Restreindre la réponse avec seulement les attributs code et libellé du lieu, dates de début et de fin des données, codes réseaux suivis, latitude, longitude et taxons suivis :
La paramètre à utiliser pour filtrer les attributs est fields, suivi des noms des attributs à conserver, séparés par une virgule. L'URL devient : https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude
Résultat :
{
"count": 353,
"first": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&page=1&size=1000",
"last": null,
"prev": null,
"next": null,
"api_version": "v1",
"data": [
{
"code_lieusurv": "1001104",
"libelle_lieusurv": "001-P-022 - Oye plage",
"date_debut_donnees": "1987-06-29T00:00:00Z",
"date_fin_donnees": "2021-02-02T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000110"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
]
"longitude": 2.00455,
"latitude": 51.002766
},
{
"code_lieusurv": "1001105",
"libelle_lieusurv": "001-P-023 - Digue du Braek",
"date_debut_donnees": "1991-02-04T00:00:00Z",
"date_fin_donnees": "1993-04-08T00:00:00Z",
"codes_reseaux": [
"0000000020"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
]
},
{
"code_lieusurv": "1001503",
"libelle_lieusurv": "001-P-071 - Dunkerque 3 S",
"date_debut_donnees": "1976-12-14T00:00:00Z",
"date_fin_donnees": "1982-09-14T00:00:00Z",
"codes_reseaux": [
"0000000022"
],
...
...
Seuls les attributs mentionnés par le paramètre fields sont maintenant renvoyés.
3. Parmi ces lieux de surveillance, ne conserver que ceux qui ont des données en 2015 :
Le paramètre à utiliser date_donnees. L'URL devient : https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&date_donnees=2015-01-01
Résultat :
{
"count": 104,
"first": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&date_donnees=2015-01-01&page=1&size=1000",
"last": null,
"prev": null,
"next": null,
"api_version": "v1",
"data": [
{
"code_lieusurv": "1001104",
"libelle_lieusurv": "001-P-022 - Oye plage",
"date_debut_donnees": "1987-06-29T00:00:00Z",
"date_fin_donnees": "2021-02-02T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000110"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"longitude": 2.00455,
"latitude": 51.002766
},
{
"code_lieusurv": "10023010",
"libelle_lieusurv": "020-P-012 - Vieux plan Est",
"date_debut_donnees": "1987-03-02T00:00:00Z",
"date_fin_donnees": "2020-12-02T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000110"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"longitude": -1.7633915,
"latitude": 48.63826
},
...
...
104 lieux de surveillance répondent aux critères.
4. Maintenant, parmi ces lieux de surveillance, ne conserver que ceux qui se trouvent dans un cercle de centre -1,8° de longitude et 48,6° de latitude, et de rayon 20 kilomètres :
Les paramètres à utiliser sont longitude, latitude et distance. L'URL devient : https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&date_donnees=2015-01-01&longitude=-1.8&latitude=48.6&distance=20
Résultat :
{
"count": 4,
"first": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&date_donnees=2015-01-01&longitude=-1.8&latitude=48.6&distance=20&page=1&size=1000",
"last": null,
"prev": null,
"next": null,
"api_version": "v1",
"data": [
{
"code_lieusurv": "10023010",
"libelle_lieusurv": "020-P-012 - Vieux plan Est",
"date_debut_donnees": "1987-03-02T00:00:00Z",
"date_fin_donnees": "2020-12-02T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000110"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"longitude": -1.7633915,
"latitude": 48.63826
},
{
"code_lieusurv": "10023032",
"libelle_lieusurv": "020-P-034 - Baie St Michel est 6",
"date_debut_donnees": "1997-07-24T00:00:00Z",
"date_fin_donnees": "2020-02-12T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000011",
"0000000110"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"longitude": -1.621016,
"latitude": 48.697372
},
{
"code_lieusurv": "10023043",
"libelle_lieusurv": "020-P-045 - Cancale port",
"date_debut_donnees": "2001-07-25T00:00:00Z",
"date_fin_donnees": "2015-06-13T00:00:00Z",
"codes_reseaux": [
"0000000022"
],
"codes_taxons_suivis": null,
"noms_taxons_suivis": null,
"longitude": -1.8283526,
"latitude": 48.669037
},
{
"code_lieusurv": "10023101",
"libelle_lieusurv": "020-P-054 - Le Vivier sur mer",
"date_debut_donnees": "1979-12-17T00:00:00Z",
"date_fin_donnees": "2017-02-09T00:00:00Z",
"codes_reseaux": [
"0000000020"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"longitude": -1.767227,
"latitude": 48.639423
}
]
}
4 lieux de surveillance répondant aux critères sont présents dans ce cercle.
5. Enfin, nous voulons filtrer sur les réseaux de mesure et ne garder que les lieux faisant partie des réseaux de code 0000000022 ou 0000000011 :
Le paramètres à utiliser est codes_reseaux. On peut mentionner plusieurs codes réseaux en les séparant par une virgule. L'URL devient : https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&date_donnees=2015-01-01&longitude=-1.8&latitude=48.6&distance=20&codes_reseaux=0000000022,0000000011
Résultat :
{
"count": 2,
"first": "https://hubeau.eaufrance.fr/api/vbeta/surveillance_littoral/lieux_surv?donnees_cc=true&fields=code_lieusurv,libelle_lieusurv,date_debut_donnees,date_fin_donnees,codes_reseaux,codes_taxons_suivis,noms_taxons_suivis,longitude,latitude&date_donnees=2015-01-01&longitude=-1.8&latitude=48.6&distance=20&codes_reseaux=0000000022,0000000011&page=1&size=1000",
"last": null,
"prev": null,
"next": null,
"api_version": "v1",
"data": [
{
"code_lieusurv": "10023032",
"libelle_lieusurv": "020-P-034 - Baie St Michel est 6",
"date_debut_donnees": "1997-07-24T00:00:00Z",
"date_fin_donnees": "2020-02-12T00:00:00Z",
"codes_reseaux": [
"0000000010",
"0000000013",
"0000000014",
"0000000020",
"0000000011",
"0000000110"
],
"codes_taxons_suivis": [
"3432"
],
"noms_taxons_suivis": [
"Mytilus edulis"
],
"longitude": -1.621016,
"latitude": 48.697372
},
{
"code_lieusurv": "10023043",
"libelle_lieusurv": "020-P-045 - Cancale port",
"date_debut_donnees": "2001-07-25T00:00:00Z",
"date_fin_donnees": "2015-06-13T00:00:00Z",
"codes_reseaux": [
"0000000022"
],
"codes_taxons_suivis": null,
"noms_taxons_suivis": null,
"longitude": -1.8283526,
"latitude": 48.669037
}
]
}
2 des lieux de surveillance appartiennent aux réseaux demandés.
6. Nous voulons récupérer les analyses du paramètre Fluoranthène (code paramètre Sandre = 1191) réalisées sur support Bivalve (code support Sandre = 21) dans un rectangle de coordonnées comprises entre -1,8 et -1,7° de longitude et 48,6 et 48,7° de latitude :
Les paramètres à utiliser sont code_parametre, code_support et bbox. L'URL à interroger est : https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/contaminants_chimiques?bbox=-1.8,48.6,-1.7,48.7&code_parametre=1191&code_support=21&size=100
Résultat :
{
"count": 23,
"first": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/contaminants_chimiques?bbox=-1.8,48.6,-1.7,48.7&code_parametre=1191&code_support=21&format=json&page=1&size=20",
"last": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/contaminants_chimiques?bbox=-1.8,48.6,-1.7,48.7&code_parametre=1191&code_support=21&format=json&page=2&size=20",
"prev": null,
"next": "https://hubeau.eaufrance.fr/api/v1/surveillance_littoral/contaminants_chimiques?bbox=-1.8,48.6,-1.7,48.7&code_parametre=1191&code_support=21&format=json&page=2&size=20",
"api_version": "v1",
"data": [
{
"code_passage": "60670853",
"mnemo_passage": "18-030",
"val_prof_passage": null,
"code_unite_prof_passage": null,
"libelle_unite_prof_passage": null,
"uri_unite_prof_passage": null,
"code_lieusurv": "10023010",
"libelle_lieusurv": "Vieux plan Est",
"mnemo_lieusurv": "020-P-012",
"code_prel": "61658276",
"mnemo_prel": null,
"date_prel": "2018-01-30T00:00:00Z",
"ecartu_prel": null,
"code_niveau_prel": "1",
"libelle_niveau_prel": "Emergé",
"code_engin_prel": "170",
"libelle_engin_prel": "Main",
"coordonnee_x_prel": -1.76339144,
"coordonnee_y_prel": 48.63826047,
"code_projection": "31",
"type_acquisition_coord": "1",
"code_producteur": "1850",
"nom_producteur": "Unité de recherche Biogéochimie et écotoxicologie (IFREMER)",
"uri_producteur": "https://id.eaufrance.fr/int/1850",
"commentaire_prel": null,
"code_echantillon": "60747388",
"mnemo_echantillon": "Suivi mixte DGAl/AE DCE DCSMM OSPAR",
"code_taxon_echantillon": null,
"nomlatin_taxon_echantillon": null,
"uri_taxon_echantillon": null,
"code_analyse": "69814095",
"code_support": "21",
"libelle_support": "Bivalve",
"uri_support": "https://id.eaufrance.fr/sup/21",
"code_fraction": "176",
"libelle_fraction": "Chair totale égouttée de bivalve",
"uri_fraction": "https://id.eaufrance.fr/fan/176",
"code_organisme_analyste": "1850",
"nom_organisme_analyste": "Unité de recherche Biogéochimie et écotoxicologie (IFREMER)",
"uri_organisme_analyste": "https://id.eaufrance.fr/int/1850",
"codes_reseaux": [
"0000000020"
],
"noms_reseaux": [
"Réseau National d'Observation de la qualité du milieu marin (RNO) - Matière vivante"
],
"uri_reseaux": [
"https://id.eaufrance.fr/dc/0000000020"
],
"date_controle_analyse": "2019-02-25T00:00:00Z",
"date_qualification_resultat": "1900-01-01T00:00:00Z",
"code_qualification_analyse": "0",
"libelle_qualification_analyse": "Non qualifié",
"commentaire_qualification_resultat": null,
"date_validation_analyse": "2019-02-25T00:00:00Z",
"commentaire_analyse": null,
"code_parametre": "1191",
"libelle_parametre": "Fluoranthène",
"uri_parametre": "https://id.eaufrance.fr/par/1191",
"resultat_analyse": 1.68,
"code_unite_resultat": "523",
"libelle_unite_resultat": "Microgramme par Kilogramme de poids frais",
"uri_unite_resultat": "https://id.eaufrance.fr/urf/523",
"code_methode": "938",
"libelle_methode": "Chromatographie gaz - Spectrométrie de masse en tandem (Veyrand et al. 2007)",
"uri_methode": "https://id.eaufrance.fr/met/938",
"longitude": -1.76339144,
"latitude": 48.63826047,
"geometry": {
"type": "Point",
"crs": {
"type": "name",
"properties": {
"name": "urn:ogc:def:crs:OGC:1.3:CRS84"
}
},
"coordinates": [
-1.76339144,
48.63826047
]
}
},
{
"code_passage": "60709688",
"mnemo_passage": "19-030",
...
...
Il y a 23 analyses répondant aux critères.